home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / mt320.arc / MT.DOC < prev    next >
Text File  |  1991-08-10  |  46KB  |  1,086 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                  MsgTrack 3.20
  23.  
  24.                                 August 11, 1991
  25.  
  26.  
  27.                                   USER MANUAL
  28.  
  29.      
  30.                    Copyright (c) 1989-1991 Andrew D. Farmer.
  31.                               All Rights Reserved.
  32.  
  33.  
  34.  
  35.                                License Statement
  36.  
  37.  
  38.           The MsgTrack package is protected by both Canadian copyright 
  39.           law and international treaty provisions.
  40.  
  41.           MsgTrack is provided as is, without warranty of any kind, 
  42.           either expressed or implied.  Andrew D. Farmer only 
  43.           guarantees that MsgTrack will occupy disk space.
  44.  
  45.           In no event shall Andrew D. Farmer be liable to you or 
  46.           anyone else for any damages, including any lost profits, 
  47.           lost savings or other incidental or consequential damages 
  48.           arising out of the use or inability to use this program.
  49.  
  50.           All Andrew D. Farmer products are trademarks or registered 
  51.           trademarks of Andrew D. Farmer.
  52.  
  53.  
  54.           ------------------------------------------------------------
  55.  
  56.           The noncommercial version of MsgTrack does not offer as many
  57.           'toys' as the commercial version, but it is =not= crippled,
  58.           nor does it quit working after a period of time.  It is
  59.           fully functional as provided.
  60.  
  61.           The noncommercial version is yours to keep. It is not public  
  62.           domain, shareware or freeware, it is simply free of charge. 
  63.  
  64.           You can use it as long as you do not use it within a
  65.           commercial environment.  It doesn't matter if you are
  66.           making money by using it or not, if you are using it within
  67.           commercial walls, you must purchase the commercial version.
  68.  
  69.           If you wish to purchase the commercial version, see the file
  70.           MT_ORDER.EUR (for europeans only) or MT_ORDER.ALL.  Both of
  71.           these files should have been located in the compressed file
  72.           MT_ORDER.ARJ, within the distribution archive.
  73.  
  74.           ------------------------------------------------------------
  75.  
  76.  
  77.                                    Chapter 1
  78.  
  79.                                     Preface
  80.  
  81.  
  82.      1.1  Archive
  83.  
  84.           The program archive, MT320.ARJ, should have included the
  85.           following files:
  86.  
  87.               MT.DOC       -  User manual.
  88.               MT.EXE       -  Main program.
  89.               MTSETUP.EXE  -  Setup program.
  90.               MTLOG.EXE    -  Log analyzer.
  91.               MT320.NEW    -  Release notes.
  92.               MT_ORDER.ARJ -  Order forms for the commercial version.
  93.  
  94.      1.2  System requirements
  95.  
  96.           Although it is possible to run MsgTrack on a system with 
  97.           less than the following equipment, the following should be 
  98.           considered the realistic minimum with which you can get by:
  99.  
  100.               A 100% IBM BIOS compatible computer system with at least 
  101.               256K of available RAM.
  102.  
  103.               MS-DOS or PC-DOS version 3.10 or greater.
  104.  
  105.      1.3  AFI environment variable
  106.  
  107.           MsgTrack will expect to find its configuration data files in  
  108.           the DOS current directory or the directory pointed to by the 
  109.           AFI environment variable.
  110.  
  111.      1.4  AFIOPT environment variable
  112.  
  113.           By default MT uses 'smart' (int 21h, function 60h) path
  114.           resolution code.  Under some configurations, this actually
  115.           returns an unuseable pathspec.  Setting AFIOPT=LOTEK_RES
  116.           tells MT to use 'dumb' or 'lotek' path resolution code
  117.           (this consists of resolving ambiguous paths to absolute
  118.           paths, but not doing any internal remapping).
  119.  
  120.      1.5  TZ environment variable
  121.  
  122.           MsgTrack uses the TZ environment variable to calculate 
  123.           Universal Coordinated Time (UTC).
  124.  
  125.           Examples:  TZ=EST05EDT   TZ=AEST-10   TZ=GMT00   TZ=UTC0
  126.  
  127.      1.6  Key
  128.  
  129.           The commercial version requires a key file for operation.  
  130.  
  131.  
  132.                                    Chapter 2
  133.  
  134.                                      Setup
  135.  
  136.  
  137.           The setup program, MTSETUP.EXE, is the backbone of MsgTrack.  
  138.           This full screen, menu driven, module is what you use to 
  139.           create and edit MsgTrack's configuration data files.
  140.  
  141.  
  142.      2.1  Video mode / command line syntax
  143.  
  144.           MTSetup will attempt to automatically use the correct video 
  145.           mode for your system, unfortunately some BIOSs return bogus 
  146.           information.  For that reason two command line options are 
  147.           available to you: -M will force MTSetup to use Mono video 
  148.           and -C will force MTSetup to use Colour video.
  149.  
  150.           Note: MTSetup uses direct screen writes.  If it detects
  151.                 DESQview, it will use the DV shadow buffer.
  152.  
  153.  
  154.      2.2  Errorlevels
  155.  
  156.           There are only 2 possible ErrorLevels that MTSetup can exit       
  157.           with.  Errorlevel 1 indicates a fatal error and Errorlevel 0 
  158.           indicates successful completion.
  159.  
  160.                   
  161.      2.3  Menus
  162.  
  163.           There are 6 top level (pull down) menus.  The settings 
  164.           available on the first 5 will be explained in this section.  
  165.           The 6th top menu, Managers, is explained in section 2.4.
  166.  
  167.  
  168.      2.3.1  File
  169.  
  170.           Copyright               This displays program identification 
  171.                                   and copyright information.  It will 
  172.                                   stay on the screen for 3 seconds, or 
  173.                                   until a key is pressed.
  174.  
  175.           Export                  This allows you to export your 
  176.                                   MsgTrack configuration data to a 
  177.                                   plain ASCII text file.
  178.  
  179.           Password                If a password is specified, all 
  180.                                   subsequent attempts to access 
  181.                                   MTSetup will require that the 
  182.                                   correct password to be provided.
  183.  
  184.  
  185.           DOS Shell               This spawns a command shell using 
  186.                                   ComSpec. When you type EXIT to 
  187.                                   return to MTSetup, it will change 
  188.                                   directories back to where you were 
  189.                                   when you loaded MTSetup.
  190.  
  191.                                   MTSetup will automatically attempt
  192.                                   to swap itself out of memory, when
  193.                                   spawning.  It will first attempt to
  194.                                   swap to EMS, if that fails it will
  195.                                   try for a swap to disk and if that
  196.                                   also fails, it will spawn without
  197.                                   swaping.
  198.  
  199.                                   You can also Shell to DOS by typing 
  200.                                   ALT-Z at any keyboard input field.
  201.  
  202.           Exit/Save               This causes MTSetup to quit and exit 
  203.                                   back to DOS. If you have made 
  204.                                   changes to your configuration, then 
  205.                                   you will be asked whether you wish 
  206.                                   to save the changes.
  207.  
  208.                                   You can also Exit/Save by typing ESC 
  209.                                   at any top level keyboard input field.
  210.  
  211.      2.3.2  General
  212.  
  213.           Address
  214.               Network Address     These are your network addresses 
  215.                                   (upto 20).
  216.  
  217.               Private Network     This is your private network number, 
  218.                                   if any.
  219.  
  220.               Domain Matching     This is a table of upto 30 domain 
  221.                                   names that should be mapped to a 
  222.                                   specific zone number.
  223.  
  224.           Sysops                  These are your names (upto 5).
  225.  
  226.                                   You can also choose whether or not
  227.                                   any messages addressed to an alias
  228.                                   (names 2-5) should be renamed so
  229.                                   that they are to your primary name.
  230.  
  231.           Paths
  232.               NetMail             This is the path to your network 
  233.                                   mail area.
  234.  
  235.               BadMail             This is the path to your bad mail 
  236.                                   area.  This is where MsgTrack will 
  237.                                   place bad messages.
  238.  
  239.           Paths
  240.               Inbound             This is the path to your mailer's 
  241.                                   inbound files area.
  242.  
  243.               SentMsgs            This is the path that you wish 
  244.                                   MsgTrack to place Sent message into.  
  245.                                   If not specified, the BadMail path 
  246.                                   will be used.
  247.  
  248.               RcvdMsgs            This is the path that you wish 
  249.                                   MsgTrack to place Received message
  250.                                   into. If not specified, the BadMail
  251.                                   path will be used.
  252.  
  253.               Nodelist            This is the path to your nodelist 
  254.                                   directory.  This is where MsgTrack 
  255.                                   will place, and expect to find, its 
  256.                                   nodelist index file (MSGTRACK.IDX).
  257.  
  258.               Semaphore           This is where MT will look for and
  259.                                   place semaphore files, such as the
  260.                                   FrontDoor rescan files.
  261.  
  262.           Nodelists               This is where you enter the names of 
  263.                                   your raw nodelist files (upto 10).  
  264.                                   This must include the complete path 
  265.                                   to the files.
  266.  
  267.                                   If you do not specify a file type 
  268.                                   (extension) MsgTrack will use the 
  269.                                   most recent file matching the trunk 
  270.                                   name.
  271.  
  272.                                   You can also choose whether or not 
  273.                                   nodes marked 'DOWN' should be 
  274.                                   included in the compiled index.
  275.  
  276.           Log Info
  277.               Log File            This is the path and name of the 
  278.                                   file that you wish MsgTrack to use 
  279.                                   for its log.  If this is not 
  280.                                   specified then there will be NO log.
  281.  
  282.               Log Data            This sub-menu allows you to select 
  283.                                   what actions your wish to have 
  284.                                   placed in the log file.  Here is a 
  285.                                   brief run-down of the action types:
  286.  
  287.                                   Fatal Errors are errors causing 
  288.                                   abortion of MsgTrack.
  289.  
  290.           Log Info
  291.               Log Data            Other Errors are non-fatal errors.
  292.  
  293.                                   Major Actions are items such as 
  294.                                   "Bounce Return Message sent to 
  295.                                   xxx/xxx", "NetMail #6 relocated to 
  296.                                   BadMail #4", "NetMail #5 Deleted".
  297.  
  298.                                   Routine Actions are items such as    
  299.                                   "Tracking, 1:163/115 -> 2:512/1".
  300.  
  301.                                   Message Info lines provide 
  302.                                   additional information about 
  303.                                   messages affected by Routine    
  304.                                   Actions.  They contain the To Name, 
  305.                                   From Name and Subject line of the    
  306.                                   message being processed.
  307.  
  308.                                   Runtime Status lines list the number 
  309.                                   of messages that MsgTrack scans in 
  310.                                   the area and the amount of RAM 
  311.                                   available for internal buffering.
  312.  
  313.                                   Trivial Messages are items such as
  314.                                   'Renumbering' and 'Total of XX
  315.                                   nodes compiled into index'. 
  316.  
  317.                                   Extended Debug logging is only 
  318.                                   useful to the author.  Turning this 
  319.                                   selection on will not have any 
  320.                                   effect unless authorized by the 
  321.                                   author.
  322.  
  323.               Log Format          This sub-menu allows you to select 
  324.                                   which of the four available log 
  325.                                   format types you wish to have used.
  326.  
  327.      2.3.3  Handling
  328.  
  329.           Attribute Bits
  330.               Strip Crash         This causes MsgTrack to remove the 
  331.                                   Crash and Hold bits from all pass- 
  332.                                   through messages.  You can make 
  333.                                   exceptions to this, see section 
  334.                                   2.4.3. 
  335.  
  336.               Strip Attach        This causes MsgTrack to remove the 
  337.                                   Attach bit from all passthrough 
  338.                                   messages.  You can make exceptions 
  339.                                   to this, see section 2.4.3. 
  340.  
  341.           Attribute Bits
  342.               Strip Transit       This causes MsgTrack to remove the 
  343.                                   In-Transit bit from all passthrough 
  344.                                   messages.  You can make exceptions 
  345.                                   to this, see section 2.4.3.
  346.  
  347.               Strip Kill          This causes MsgTrack to remove the 
  348.                                   Kill/Sent bit from all passthrough 
  349.                                   messages.  You can make exceptions 
  350.                                   to this, see section 2.4.3.
  351.  
  352.               Add Private         This causes MsgTrack to add the 
  353.                                   Private bit to all passthrough 
  354.                                   messages.
  355.  
  356.               Strip Freq          This causes MsgTrack to remove the 
  357.                                   XX2, FileRequest, ReceiptRequest, 
  358.                                   Receipt, Audit and UpdateRequest 
  359.                                   bits from all passthrough messages.
  360.  
  361.           Miscellaneous
  362.               Strip Flags         This causes MsgTrack to remove the 
  363.                                   FLAGS handling kludge from all 
  364.                                   passthrough messages.  You can make 
  365.                                   exceptions to this, see section 
  366.                                   2.4.3. 
  367.  
  368.                                   This action will be ignored if the 
  369.                                   Attach bit is set.
  370.  
  371.               Stop Wild Att       This causes MsgTrack to remove the 
  372.                                   Attach bit from passthrough msgs, if 
  373.                                   (and only if) the attached filespec 
  374.                                   includes wildcard characters.
  375.  
  376.               Clear Cost          This causes MsgTrack to reset the 
  377.                                   Cost field in the msg header to zero 
  378.                                   (0) on all passthrough messages.
  379.  
  380.      2.3.4  Actions
  381.  
  382.           NodeList Lookup
  383.               Check NodeList      This tells MsgTrack to check through 
  384.                                   the nodelist index for the Origin 
  385.                                   and Destination Address on each msg.  
  386.                                   If the address is not found, the 
  387.                                   message will not be forwarded.
  388.  
  389.                                   If this is not turned on, none of 
  390.                                   the other NodeList Lookup functions 
  391.                                   will be operative.
  392.  
  393.           NodeList Lookup
  394.               Only My Zone        This tells MsgTrack to only confirm 
  395.                                   the existence of the Zone, not the 
  396.                                   Net and Node, for addresses outside 
  397.                                   of your primary Zone.
  398.  
  399.               Skip Node Level     This tells MsgTrack not to check the 
  400.                                   Node address, only the Zone and Net, 
  401.                                   for addresses outside of your net.
  402.  
  403.               Return Bad Dest     This tells MsgTrack to Return 
  404.                                   messages with unknown destination 
  405.                                   addresses to the sender.
  406.  
  407.                                   The text for the return message may
  408.                                   be specified in BAD_DEST.MTB (in
  409.                                   the AFI env dir).  If this file is
  410.                                   not present, default text will be
  411.                                   used.
  412.  
  413.               Warn Bad Orig       This tells MsgTrack to warn the 
  414.                                   recipient if the origin address on 
  415.                                   the message is unlisted.
  416.  
  417.               Hold Bad Orig       This tells MsgTrack to move any 
  418.                                   message with an unknown origin 
  419.                                   address to BadMail (or, delete it if 
  420.                                   the following option is used).
  421.  
  422.               Kill Failed Msgs    This tells MsgTrack to delete 
  423.                                   messages that failed the Nodelist 
  424.                                   lookup, instead of moving them to 
  425.                                   the BadMail area.
  426.  
  427.           EchoMail Handler  
  428.               Bounce EchoMail     This tells MsgTrack to disallow 
  429.                                   routed EchoMail. You can make 
  430.                                   exceptions to this, see section 
  431.                                   2.4.3.
  432.  
  433.                                   If this is not turned on, none of 
  434.                                   the other EchoMail Handler functions 
  435.                                   will be operative.
  436.  
  437.               Return to Sender    This tells MsgTrack to Return routed 
  438.                                   EchoMail messages to the sender.
  439.  
  440.                                   The text for the return message may
  441.                                   be specified in ECHOMAIL.MTB (in
  442.                                   the AFI env dir).  If this file is
  443.                                   not present, default text will be
  444.                                   used.
  445.  
  446.           EchoMail Handler  
  447.               Kill Failed Msgs    This tells MsgTrack to delete routed 
  448.                                   EchoMail messages, instead of moving 
  449.                                   them to the BadMail area.
  450.  
  451.           Bad UUCP Handler  
  452.               Bounce Bad UUCP     This tells MsgTrack to bounce 
  453.                                   messages that are addressed to UUCP
  454.                                   on your system, but do not contain
  455.                                   a valid TO: routing line.
  456.  
  457.                                   This option is only useful to those
  458.                                   running a FidoNet<->UUCP gateway.
  459.  
  460.                                   If this is not turned on, none of 
  461.                                   the other Bad UUCP Handler functions 
  462.                                   will be operative.
  463.  
  464.               Return to Sender    This tells MsgTrack to Return bad 
  465.                                   UUCP messages to the sender.
  466.  
  467.                                   The text for the return message may
  468.                                   be specified in BAD_UUCP.MTB (in
  469.                                   the AFI env dir).  If this file is
  470.                                   not present, default text will be
  471.                                   used.
  472.  
  473.               Kill Failed Msgs    This tells MsgTrack to delete bad 
  474.                                   UUCP messages, instead of moving
  475.                                   them to the BadMail area.
  476.  
  477.  
  478.           Send Copies             You may enter a list of upto 5 
  479.                                   addresses where you wish messages 
  480.                                   addressed to you to be copied.  
  481.  
  482.                                   MsgTrack treats a message as  being 
  483.                                   addressed to you if it is addressed 
  484.                                   to one of the names listed under 
  485.                                   Sysops (see section 2.3.2) at one of 
  486.                                   your addresses (see section 2.3.2).
  487.  
  488.                                   You may additionally specify whether 
  489.                                   or not the original message should 
  490.                                   be deleted after it has been 
  491.                                   processed by Send Copies.  
  492.  
  493.      2.3.5  Miscellaneous
  494.  
  495.           Action Settings
  496.               Bounce Local Msgs   This tells MsgTrack to apply all
  497.                                   configured 'bounce' tests against
  498.                                   locally entered messages (mail
  499.                                   to/from your system), as well as
  500.                                   to passthrough mail.
  501.  
  502.           Action Settings
  503.               Ignore Zones        This tells MsgTrack to ignore Zone 
  504.                                   numbers during all address lookups.
  505.  
  506.               Move Sent Msgs      This tells MsgTrack to move msgs 
  507.                                   marked 'Sent' to the SentMsgs area.
  508.  
  509.               Move Rcvd Msgs      This tells MsgTrack to move msgs 
  510.                                   marked 'Rcvd' to the RcvdMsgs area.
  511.  
  512.               Gate INTL Mail      This tells MsgTrack to Zonegate 
  513.                                   route any Inter-Zone messages that 
  514.                                   are not already Zonegated.
  515.  
  516.               UnGate INTL Mail    This tells MsgTrack to remove Zone- 
  517.                                   gate routing on Inter-Zone messages.
  518.  
  519.               Keep Bounce Msgs    This tells MsgTrack not to mark any 
  520.                                   of the return messages, associated 
  521.                                   with bouncing mail, as Kill/Sent.
  522.  
  523.               FrontDoor Rescan    This tells MsgTrack to force 
  524.                                   FrontDoor (mailer/editor) to rescan 
  525.                                   the NetMail area if any changes have 
  526.                                   been made to the contents.
  527.  
  528.               Renumber NetMail    This tells MsgTrack to renumber the 
  529.                                   NetMail area.
  530.  
  531.                                   You can also cause multiple areas
  532.                                   to be renumbered by using the
  533.                                   -R<file> command line option.
  534.  
  535.               Full Screen Mode    This tells MsgTrack to operate in 
  536.                                   Full Screen mode, instead of BIOS
  537.                                   scroll mode.
  538.  
  539.               Force INTL Line     This tells MsgTrack to place an
  540.                                   INTL line into =all= messages.
  541.  
  542.               Process Packets     This tells MsgTrack to unpack any
  543.                                   mail packets (*.PKT files) that are
  544.                                   in your Inbound area.
  545.  
  546.               Kill Inbound Freq   This tells MsgTrack to delete any
  547.                                   message that is addressed to your
  548.                                   system and has the File Request or
  549.                                   Update Request attribute bit set.
  550.  
  551.           Colour Choices
  552.               Customized          This allows you to manually select 
  553.                                   what colours MsgTrack will use while 
  554.                                   operating in Full Screen Mode.
  555.  
  556.           Colour Choices
  557.               Default mono set    This tells MsgTrack to use its 
  558.                                   default monochrone colour set while 
  559.                                   operating in Full Screen Mode.
  560.  
  561.               Default colour set  This tells MsgTrack to use its 
  562.                                   default CGA/EGA/VGA colour set while 
  563.                                   operating in Full Screen Mode.
  564.  
  565.  
  566.      2.4  Managers
  567.  
  568.           The managers allow you to control MsgTrack's powerful Point, 
  569.           Node, Exceptions and Routing handling functions.  All four
  570.           managers will now be explained.
  571.  
  572.  
  573.      2.4.1  Point Manager
  574.  
  575.           The Point Manager is a complete Point management interface.  
  576.           It allows you to specify upto 500 points and fully control 
  577.           what actions will be taken on each.
  578.  
  579.           Note that nothing you do in the Point Manager will become 
  580.           permanent until you exit and save your changes.
  581.  
  582.  
  583.      2.4.1.1  Wildcard macros
  584.  
  585.           When entering a name, you may specify an asterix (*) at the
  586.           end of the name.  This will cause a strict match only to be
  587.           made upto that point in the string, escentially wildcarding
  588.           the tail end of the string.
  589.  
  590.           Example:  Using "Andre*" would cause a match with "andrew
  591.                     farmer", "Andre Gagnon" or "Andrea Johnson".
  592.  
  593.  
  594.      2.4.1.2  Keystroke actions
  595.  
  596.           Enter                   Edit an existing entry.
  597.  
  598.           F1                      Toggle the active status of the 
  599.                                   current entry.  If the active status 
  600.                                   is set to no, then the entry will be 
  601.                                   ignored.
  602.  
  603.           F2                      Toggle the Mapping method.  This can 
  604.                                   be set to either Point or PvtNet.  
  605.                                   If set to Point, mail for that point 
  606.                                   will be addressed using a fully 
  607.                                   qualified 4-dimensional address.  If 
  608.                                   set to PvtNet, mail for that point 
  609.                                   will be addressed using a 3-
  610.                                   dimensional private network address.
  611.  
  612.           F3                      Global settings:
  613.  
  614.                                   If 'Map from Pvt Net' is set to yes, 
  615.                                   then any mail that originates in 
  616.                                   your private network will be 
  617.                                   remapped to show a fully qualified 
  618.                                   4-dimensional origin address.
  619.  
  620.                                   If 'Files to Points' is set to yes, 
  621.                                   then mail addressed to your points, 
  622.                                   that also has the Attach bit set, 
  623.                                   will have your Inbound path inserted 
  624.                                   as the 'attach path' for the file.
  625.  
  626.           F4                      Export your Point Manager config to 
  627.                                   a flat ASCII file.
  628.  
  629.           Ins                     Insert a new entry.
  630.  
  631.           Del                     Delete an existing entry.
  632.  
  633.           Esc                     Exit/Save.
  634.  
  635.  
  636.      2.4.2  Node Manager
  637.  
  638.           The Node Manager is a complete Node management interface.  
  639.           It allows you to specify upto 500 addresses, or user names, 
  640.           whose mail you wish to have readdressed to a different 
  641.           destination.
  642.  
  643.           Note that nothing you do in the Node Manager will become 
  644.           permanent until you exit and save your changes.
  645.  
  646.  
  647.      2.4.2.1  Wildcard macros
  648.  
  649.           When entering a name, you may specify an asterix (*) at the
  650.           end of the name.  This will cause a strict match only to be
  651.           made upto that point in the string, escentially wildcarding
  652.           the tail end of the string.
  653.  
  654.           Example:  Using "Andre*" would cause a match with "andrew
  655.                     farmer", "Andre Gagnon" or "Andrea Johnson".
  656.  
  657.      2.4.2.2  Select menu
  658.      
  659.           A note about the 'Select' menu that will pop up whenever you 
  660.           hit Enter or Ins.
  661.  
  662.           If you select 'UserName' then you will be asked to enter a 
  663.           username followed by the node where that user's mail should 
  664.           be sent.  Note that only mail addressed to the specified 
  665.           user AT ONE OF YOUR ADDRESSES will be processed in this 
  666.           case.
  667.  
  668.           If you select 'Address' then you will be asked to enter a 
  669.           network address followed by the node where the mail should 
  670.           be readdressed.
  671.  
  672.           The default display screen will show an at sign (@) in front 
  673.           of all entries where you have selected 'Address'.
  674.  
  675.  
  676.      2.4.2.3  Keystroke actions
  677.  
  678.           Enter                   Edit an existing entry.
  679.  
  680.           F1                      Toggle the active status of the 
  681.                                   current entry.  If the active status 
  682.                                   is set to no, then the entry will be 
  683.                                   ignored.
  684.  
  685.           F4                      Export your Node Manager config to a 
  686.                                   flat ASCII file.
  687.  
  688.           Ins                     Insert a new entry.
  689.  
  690.           Del                     Delete an existing entry.
  691.  
  692.           Esc                     Exit/Save.
  693.  
  694.  
  695.      2.4.3  Exceptions Manager
  696.  
  697.           The Exceptions Manager is a complete Exceptions management 
  698.           interface.  It allows you to specify upto 500 addresses 
  699.           (wildcards are allowed, read on) that should be excepted 
  700.           from 'Strip Crash', 'Strip Attach', 'Strip Kill/Transit', 
  701.           'Strip Flags' and/or 'Bounce EchoMail' actions.
  702.  
  703.           Note that nothing you do in the Exceptions Manager will 
  704.           become permanent until you exit and save your changes.
  705.  
  706.      2.4.3.1  Wildcard macros
  707.  
  708.           When entering an address, you may specify an asterix (*) in 
  709.           any, or all, address portions (the 4 valid address portions 
  710.           are:  Zone, Net, Node and Point).
  711.  
  712.           Note that wildcarding will auto-flow in a greater to lesser 
  713.           direction.  That means that if you specify an asterix in the 
  714.           Net position, Node and Point will also be wildcarded.
  715.  
  716.           For example:
  717.  
  718.               Entering 1:163/* will cause any node in Zone 1, Network 
  719.               163, plus all point under them, to be excepted from the 
  720.               specified actions.  This would be displayed on the 
  721.               default screen as 1:163/All.All.
  722.  
  723.               Entering 3:*/* will cause any node/point in Zone 3 to be 
  724.               excepted from the specified actions.  This would be 
  725.               displayed on the default screen as 3:All/All.All.
  726.  
  727.               Entering 1:163/115.* will cause all points of 1:163/115 
  728.               to be excepted from the specified actions.  This would 
  729.               be displayed on the default screen as 1:163/115.All.
  730.  
  731.  
  732.      2.4.3.2  Keystroke actions 
  733.  
  734.           Enter                   Edit an existing entry.
  735.  
  736.           F1                      Toggle the active status of the 
  737.                                   current entry.  If the active status 
  738.                                   is set to no, then the entry will be 
  739.                                   ignored.
  740.  
  741.           F2                      Select Origination exceptions. These 
  742.                                   are the actions that the specified 
  743.                                   address(es) should be excepted from 
  744.                                   if the message is FROM them.
  745.  
  746.           F3                      Select Destination exceptions. These 
  747.                                   are the actions that the specified 
  748.                                   address(es) should be excepted from 
  749.                                   if the message is FROM them.
  750.  
  751.           F4                      Export your Exceptions Manager 
  752.                                   config to a flat ASCII file.
  753.  
  754.           Ins                     Insert a new entry.
  755.  
  756.           Del                     Delete an existing entry.
  757.  
  758.           Esc                     Exit/Save.
  759.  
  760.  
  761.      2.4.4  Routing Manager
  762.  
  763.           The Routing Manager is a complete Routing management
  764.           interface.  It allows you to specify upto 500 addresses
  765.           (with user names if you wish), whose mail you will not
  766.           route.
  767.  
  768.           You may further select to disallow mail FROM this
  769.           address/name, mail TO this address/name or go hog wild and
  770.           disallow mail that is either FROM or TO this address/name.
  771.  
  772.           Note that nothing you do in the Routing Manager will become 
  773.           permanent until you exit and save your changes.
  774.  
  775.  
  776.      2.4.4.1  Wildcard macros
  777.  
  778.           When entering an address, you may specify an asterix (*) in 
  779.           any, or all, address portions (the 4 valid address portions 
  780.           are:  Zone, Net, Node and Point).
  781.  
  782.           Note that wildcarding will auto-flow in a greater to lesser 
  783.           direction.  That means that if you specify an asterix in the 
  784.           Net position, Node and Point will also be wildcarded.
  785.  
  786.           For example:
  787.  
  788.               Entering 1:163/* will cause any node in Zone 1, Network 
  789.               163, plus all point under them, to be excepted from the 
  790.               specified actions.  This would be displayed on the 
  791.               default screen as 1:163/All.All.
  792.  
  793.               Entering 3:*/* will cause any node/point in Zone 3 to be 
  794.               excepted from the specified actions.  This would be 
  795.               displayed on the default screen as 3:All/All.All.
  796.  
  797.               Entering 1:163/115.* will cause all points of 1:163/115 
  798.               to be excepted from the specified actions.  This would 
  799.               be displayed on the default screen as 1:163/115.All.
  800.  
  801.      2.4.4.2  Keystroke actions
  802.  
  803.           Enter                   Edit an existing entry.
  804.  
  805.           F1                      Toggle the active status of the 
  806.                                   current entry.  If the active status 
  807.                                   is set to no, then the entry will be 
  808.                                   ignored.
  809.  
  810.           F2                      Select your DisAllow value.  It may
  811.                                   be set to NONE, TO, FROM or BOTH.
  812.  
  813.           F3                      Global settings:
  814.  
  815.                                   If 'Return to Sender' is set to yes, 
  816.                                   then any mail that is bounced on a
  817.                                   routing violation will be returned
  818.                                   to the sender.
  819.  
  820.                                   If 'Kill Failed Msgs' is set to yes, 
  821.                                   then any mail that is bounced on a
  822.                                   routing violation will be deleted,
  823.                                   instead of being relocated to the
  824.                                   BadMail area.
  825.  
  826.           F4                      Export your Routing Manager config
  827.                                   to a flat ASCII file.
  828.  
  829.           Ins                     Insert a new entry.
  830.  
  831.           Del                     Delete an existing entry.
  832.  
  833.           Esc                     Exit/Save.
  834.  
  835.  
  836.                                    Chapter 3
  837.  
  838.                                     MsgTrack
  839.  
  840.  
  841.           The main program, MT.EXE, is ready to run once you have
  842.           configured with MTSetup and placed SYSTEM.MT (plus MT.KEY,
  843.           POINTSYS.MT, NODESYS.MT, EXCEPSYS.MT and ROUTESYS.MT if
  844.           applicable) into one of the directories where MsgTrack will
  845.           look for them (see section 1.3).
  846.  
  847.  
  848.      3.1  Video mode
  849.  
  850.           When operating in Full Screen mode, MsgTrack uses direct 
  851.           screen writes.  When operating in Scroll mode, MsgTrack 
  852.           writes to the screen using calls to the undocumented BIOS 
  853.           interrupt 29.  In both cases output in =not= redirectable.
  854.  
  855.           Note:  If MsgTrack detects DESQview, any direct screen
  856.                  writes will be done via the DV shadow buffer.
  857.  
  858.  
  859.      3.2  Command line syntax
  860.  
  861.           MsgTrack can be executed without any command line options, 
  862.           but a number of specialized features are available from the 
  863.           command  line.  Command line switches may be  preceded  with 
  864.           either a dash (-) or the currently configured DOS switch
  865.           char (normally a forward slash).
  866.  
  867.           Syntax/Usage:  MT <optional switches>
  868.  
  869.               -?                  This will cause MsgTrack to display 
  870.                                   a Syntax/Usage screen, then abort 
  871.                                   with nothing Done.
  872.  
  873.               -A                  By default, MsgTrack will NEVER
  874.                                   process message from ARCmail or
  875.                                   Tick on your system.  This switch
  876.                                   will override that default.
  877.  
  878.               -D                  When used with -P, this will cause 
  879.                                   the file(s) to be deleted after 
  880.                                   being posted.
  881.  
  882.               -F                  This will force MsgTrack to compile 
  883.                                   its NodeList Index, even if no 
  884.                                   compile is necessary, then abort 
  885.                                   with nothing else done.
  886.  
  887.               -L                  This will cause MsgTrack to NEVER
  888.                                   bounce locally entered messages.
  889.  
  890.               -Mdir               This will cause MsgTrack to scan the 
  891.                                   path specified by 'dir', instead of 
  892.                                   the NetMail area specified in your 
  893.                                   configuration.
  894.  
  895.               -N                  By default, MsgTrack will will 
  896.                                   automatically re-compile its 
  897.                                   NodeList index if it judges that a 
  898.                                   compile is necessary. Using this 
  899.                                   switch will 'short circuit' the 
  900.                                   auto-compile logic, telling MsgTrack 
  901.                                   to use the existing Index file, even 
  902.                                   if it is out-of-date.
  903.  
  904.               -Pfile              This will cause MsgTrack to post the 
  905.                                   file(s) specified by 'file' as msgs 
  906.                                   in your NetMail area. 'file' can 
  907.                                   include wildcards characters.
  908.  
  909.               -Q                  This will cause MsgTrack to run in 
  910.                                   Quiet mode, providing only minimal 
  911.                                   screen output.
  912.  
  913.               -R<file>            This will cause MsgTrack to renumber 
  914.                                   the NetMail area, then exit with 
  915.                                   nothing else done.
  916.  
  917.                                   The optional <file> is a raw ASCII 
  918.                                   text file listing one directory path 
  919.                                   per line.  If this is specified, 
  920.                                   then MsgTrack will renumber all 
  921.                                   directories listed therein.
  922.  
  923.               -S                  This causes MsgTrack NOT to include
  924.                                   the Subject line in 'Message Info'
  925.                                   log enties.
  926.  
  927.               -Tlogfile           This tells MsgTrack to use the 
  928.                                   path/filename specified by 'logfile' 
  929.                                   for its log, instead of the log file 
  930.                                   specified in your configuration.
  931.  
  932.  
  933.      3.3  Errorlevels
  934.  
  935.           The  following is a run-down of the 4 possible ErrorLevels 
  936.           that MsgTrack can exit with:
  937.  
  938.           Errorlevel 3            MsgTrack processed some messages.
  939.  
  940.           Errorlevel 2            Fatal Error - program abortion.
  941.  
  942.           Errorlevel 1            Fatal Error - program abortion.
  943.  
  944.           Errorlevel 0            Successful completion.
  945.  
  946.  
  947.                                    Chapter 4
  948.  
  949.                                   Log Analyzer
  950.  
  951.  
  952.           The log analyzer, MTLOG.EXE, is a small utility program
  953.           that will take as input a MsgTrack log (wildcards are
  954.           valid, so you can process multiple logs in one pass) and
  955.           output a report file.
  956.  
  957.  
  958.      4.1  Report
  959.  
  960.           The report file consists of 3 sections.
  961.  
  962.           The Activity report lists the total number of times a
  963.           particular action was executed.
  964.  
  965.           The From report lists msgs/bytes that were FROM a specific
  966.           address, no matter what the destination address was.
  967.  
  968.           The To report lists msgs/bytes that were TO a specific
  969.           address, no matter what the origination address was.
  970.  
  971.  
  972.      4.2  Video mode
  973.  
  974.           MTLog uses Standard Output for screen writes.
  975.  
  976.  
  977.      4.3  Command line syntax
  978.  
  979.           MTLog must be executed with two (2) command line options.
  980.  
  981.           Syntax/Usage:  MTLog [LogFile] [Report]
  982.  
  983.               LogFile             This is the MT logs(s) you wish to
  984.                                   process.  Wildcards are valid.
  985.  
  986.               Report              This is the path/filespec MTLog
  987.                                   should write its report file to.
  988.                                   Note that MTLog will OVERWRITE any
  989.                                   existing file by this name.
  990.  
  991.      4.4  Errorlevels
  992.  
  993.           The following are the 2 possible ErrorLevels that MTLog can
  994.           exit with:
  995.  
  996.           Errorlevel 1            Fatal Error - program abortion.
  997.  
  998.           Errorlevel 0            Successful completion.
  999.  
  1000.  
  1001.                                    Appendix A
  1002.  
  1003.                           Program support - Help nodes
  1004.  
  1005.  
  1006.           If you have any questions, concerns or reports of unexpected 
  1007.           behavior in the software, the author can be contacted in the 
  1008.           following ways:
  1009.  
  1010.  
  1011.           Electronic:
  1012.  
  1013.               FidoNet:     1:163/115
  1014.  
  1015.               Internet:    adf@aficom.ocunix.on.ca
  1016.  
  1017.  
  1018.           Surface:
  1019.  
  1020.               Andrew D. Farmer
  1021.               P.O.Box 11087, Station H
  1022.               Nepean, Ontario
  1023.               K2H 7T8  CANADA
  1024.  
  1025.  
  1026.           Inquiries and questions about installation or operation may 
  1027.           also be addressed to the following help nodes: 
  1028.  
  1029.  
  1030.           Europe:                 Noel Bradford
  1031.                                   London, UK
  1032.                                   2:257/102@fidonet
  1033.  
  1034.                                   Peter Janssens
  1035.                                   Venray, Netherlands
  1036.                                   2:512/1@fidonet
  1037.  
  1038.           North America:          Bruce Bodger
  1039.                                   Tulsa, Oklahoma
  1040.                                   1:170/400@fidonet
  1041.  
  1042.  
  1043.  
  1044.                                    Appendix B
  1045.  
  1046.                            Thanks for all the fish...
  1047.  
  1048.  
  1049.           I would like to take this opportunity to thank all the 
  1050.           people that helped to make MsgTrack 3.20 what it is. They 
  1051.           tested the pants off it, they contributed many excellent 
  1052.           feature ideas and, above all, they are a great bunch of 
  1053.           people who deserve extra credit for putting up with my 
  1054.           attitude. <grin>
  1055.  
  1056.           I present my Beta Testers (alphabetically):
  1057.  
  1058.           Bruce Bodger, Noel Bradford, Orlando Castillo, David Dodell,
  1059.           Tom Hall, Jesse Hollington, Mark Howard, Dave Hunter,
  1060.           Peter Janssens, Felix Kasza, Joop Mellaart, George Peace,
  1061.           James Smith, Dieter Soltau, John Souvestre, Ken Wilson.
  1062.  
  1063.           Special thanks go to Joaquim Homrighausen, for a host of
  1064.           reasons.
  1065.  
  1066.                                 Closing comments    
  1067.  
  1068.           I have tried to make this documentation as complete as 
  1069.           possible, but there are always some small things that slip 
  1070.           through the cracks and aren't documented, or aren't 
  1071.           documented correctly.  I apologize in advance for any such 
  1072.           errors that may occur.
  1073.    
  1074.           I hope that you enjoy using MsgTrack and that it provides 
  1075.           you with the features you need to keep control of your 
  1076.           NetMail area. 
  1077.  
  1078.           MsgTrack is still very much 'in development' and I am always 
  1079.           open to feature suggestions, so please feel free to let me 
  1080.           know if you have some ideas that would make MsgTrack even 
  1081.           better.
  1082.  
  1083.           Andrew D. Farmer
  1084.           Ottawa, Ontario
  1085.           August 11, 1991
  1086.